home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 4 / Meeting Pearls Vol. IV (1996)(GTI - Schatztruhe)[!].iso / Pearls / etech / Spice / spice3f5r3.readme < prev    next >
Text File  |  1996-09-04  |  10KB  |  276 lines
  1. Short:    Analog Ckt. Simulator r1.3
  2. Uploader: henric@zoom.com
  3. Author:   henric@zoom.com
  4. Type:     misc/sci
  5. Replaces: misc/sci/spice3f5r2*
  6.  
  7. Spice3f5 Amiga Release 1.3
  8.  
  9. spice3f5r3_000.lha
  10.     Spice for any CPU.
  11. spice3f5r3_020.lha
  12.     Spice with inline FPU math for 020+
  13.  
  14.  
  15. What is this?
  16.  
  17. This is a full port of Spice3f5.  All device models and analyses in the 3f5 
  18. distribution have been included.  The full simulator has been built, but 
  19. the stand-alone "nutmeg" has not (nutmeg is spice without any simulation 
  20. capabilities).  "proc2mod" and "multidec" have been included and seem to 
  21. generate reasonable output. 
  22.  
  23.  
  24. What's new?
  25.  
  26. -- Recompiled with SAS/C 6.56.
  27.  
  28. -- The "000" version now uses the standard math libraries instead
  29.    of the IEEE libraries.
  30.  
  31. -- New email address for author.
  32.  
  33. -- Bug fixes.
  34.     
  35.  
  36. Requirements
  37.  
  38. -- AmigaOS 2 or better.
  39.  
  40. -- A few megs of ram.  (I don't know really.  The full executable
  41.    is about a megabyte.)
  42.  
  43.  
  44. Supported features
  45.  
  46.     The lite version supports the following devices:
  47.                 asrc:   arbitrary voltage/current source
  48.                 bjt:    bipolar junction transistor
  49.                 cap:    capacitor
  50.                 cccs:   current-controlled current source
  51.                 ccvs:   current-controlled voltage source
  52.                 csw:    current controlled switch
  53.                 dio:    diode
  54.                 ind:    inductor
  55.                 isrc:   current source
  56.                 jfet:   Junction FET
  57.                 mos1:   MOS, simplest analytic model, fastest
  58.                 mos2:   MOS, middle complexity and accuracy
  59.                 mos3:   MOS, most complicated, most accurate
  60.                 res:    resistor
  61.                 sw:     switch
  62.                 urc:    uniform RC line
  63.                 vccs:   voltage-controlled current source
  64.                 vcvs:   voltage-controlled voltage source
  65.                 vsrc:   voltage source
  66.  
  67.      The full version supports these additional devices:
  68.                 bsim1:  detailed MOS model
  69.                 bsim2:  detailed MOS model, revised version of bsim1
  70.                 ltra:   lossy transmission line
  71.                 mes:    MES FET (GaAs)
  72.                 mos6:   MOS, new, fast analytic, short-channel
  73.                 tra:    lossless transmission line
  74.  
  75.      The lite version supports these analyses:
  76.                 op:     DC operating point
  77.                 dc:     DC transfer curve
  78.                 tf:     Small signal transfer function
  79.                 ac:     AC (frequency domain)
  80.                 tran:   transient
  81.  
  82.      The full version supports these additional analyses:
  83.                 pz:     pole-zero
  84.                 disto:  distortion
  85.                 noise:  noise
  86.                 sense:  sensitivity
  87.  
  88. Installation
  89.  
  90. Just decompress it.  It's ready to run.  No silly assigns or anything! 
  91. (Well, maybe add the "bin" directory to you path.  Also, renaming the 
  92. binaries saves some typing.)
  93.  
  94. As a quick "getting started" guide, see the file "spice.transcript".
  95.  
  96. If you are tight on memory, try the "lite" version of the executable.  It 
  97. does not contain some device models, and the more esoteric analyses are not 
  98. supported. 
  99.  
  100.  
  101. Documentation
  102.  
  103. For spice in general...
  104. Online help is available with the "help" command.  An AmigaGuide version of 
  105. the same document can be found in the directory "SpiceGuide" (courtesy Ron 
  106. Charlton).  The alias "aghelp" is defined in the initialization file 
  107. (lib/scripts/spinit).  It will load the .guide file from the location 
  108. specified in the spinit file; see the "spinit" file to set the path to 
  109. match your configuration.
  110.  
  111. The full docs in PostScript format are available by anonymous ftp from 
  112. "ic.eecs.berkeley.edu" or "ilpsoft.eecs.berkeley.edu".  This site also 
  113. contains more example circuits. 
  114.  
  115. For this port...
  116. There is a plot screen that opens behind your other screens.  The fact that 
  117. LAmiga-M/N can be used to flip screens will probably prove useful.
  118.  
  119. I have added a few new variables:
  120.  
  121.    hcopylinewidth    When this variable is set, PostScript output   
  122.                      will contain a "setlinewidth" directive.
  123.  
  124.    screenwidth       If these are not set, then Intuition will
  125.    screenheight      pick some reasonable values for you.
  126.  
  127.    screendepth       If this is not set, then the depth will be
  128.                      copied from the default public screen (Note:
  129.                      Spice will not use more than 20 colors, so I
  130.                      limit the depth copied from the default
  131.                      public screen to 5 bit-planes. However, a
  132.                      depth specified in the "screendepth"
  133.                      variable will _not_ be altered in any way;
  134.                      it is passed directly to OpenScreen().)
  135.  
  136.    screenmode        This is a hexadecimal number that is passed
  137.                      to OpenScreenTags() as the DisplayID.  When
  138.                      this variable is not set, the DisplayID is
  139.                      copied from the default public screen.
  140.  
  141.    fontname          Take a wild guess.... Like the others if
  142.    fontheight        either or both are not set then defaults
  143.                      will be used (XEN.font/8).
  144.  
  145. See the file "lib/scripts/spinit" for more information about these 
  146. variables.
  147.  
  148.  
  149. Known problems
  150.  
  151. Spice makes sure that the stack is 64k or greater, but this is not always 
  152. enough.  If you have a crash, try increasing the size of the stack.  If it 
  153. still crashes, please send me a copy of the relevant source file(s) and a 
  154. description of how to reproduce the problem.
  155.  
  156. Repeated uses of "iplot" in the same session seem to have odd results. 
  157. Nothing explodes, but the resulting graphs can be rather strange.
  158.  
  159. The internal pager could be more clever about the size of the shell window.
  160.  
  161. There is apparently a bug in OpenScreen that causes the default system font 
  162. to be closed when OpenScreen fails.  This is not a problem as long as the 
  163. total number of "open" instances of that font is greater than the number of 
  164. failed "OpenScreenTags()" calls.
  165.  
  166.  
  167. Notes
  168.  
  169. The 020+ executables were actually optimized for the 040.  I have been 
  170. assured by the SAS folks that the executables will run just fine on the 
  171. 68020 and the 68030.
  172.  
  173. Spice expects some files to be in "progdir:/lib" so if you move files 
  174. around, keep this in mind. Some AmigaDOS magic makes "progdir:"  point to 
  175. there directory where the program is located. (If spice doesn't find these 
  176. files then it will complain, but all should work anyway--except for the 
  177. online help).  You can change where the program looks for the help file
  178. with a "set helppath=a:b/c/d".  The "spinit" file is a good place to put 
  179. this.
  180.  
  181. All the executables are "pure" and can be made resident (one must either 
  182. use "resident <filename> pure" or set the "p" bit on the executables since 
  183. "lha" does not preserve the pure bit). However, if you make spice resident 
  184. then "progdir:" does not work.  To get around this problem use these 
  185. environment variables:
  186.    setenv SPICE_LIB_DIR "wherever:you/wantyour/lib/dir/to/be"
  187.    setenv SPICE_EXEC_DIR "where:the/spice/executable/is"
  188. There are other environment variables that spice looks for, including:
  189. SPICE_NEWS, SPICE_HELP_DIR (this is another way to deal with the problem 
  190. described in the previous paragraph), SPICE_SCRIPTS, SPICE_EDITOR, 
  191. SPICE_ASCIIRAWFILE.
  192.  
  193. If you have the environment variable "HOME" set, then "cd" will change the 
  194. current directory to $HOME when given a null argument.
  195.     
  196. And Thanks to...
  197.  
  198. -- SAS for making a great compiler.
  199.  
  200. -- Those of you who have taken the time to write with both
  201.    compliments and complaints.
  202.  
  203.  
  204. History
  205.  
  206. 1.0 (Initial release)
  207.  
  208. 1.1
  209. -- Added new variable "hcopydevwidth" because PostScript output
  210.    looked like it was drawn with crayons.
  211. -- Updated physical constants to Nov. 86 CODATA Bulletin. (Not
  212.    that a couple parts per million matter, but the FPU will be
  213.    using all it's bits anyway, so why not?)
  214. -- Commented out all "ScreenToFront()" and "ScreenToBack()"
  215.    calls.  You have to find the plot yourself now, but I think it
  216.    much less annoying.
  217. -- Fixed a problem with "sourcepath".  The "source" command will 
  218.    now try looking in the current directory.
  219. -- Screen colors are now set to something more reasonable (not
  220.    perfect yet).
  221. -- Fixed a minor problem with Smith plots.  This required
  222.    rewriting some of Berkeley's wonderful code.  ...and this    
  223.    led to a little problem in my own code... and then to some
  224.    more in Berkeley's.
  225. -- Plots now use JAM1 instead of JAM2.
  226. -- The "slowplot" variable is not ignored anymore (i.e., it
  227.    works).
  228. -- New screen variables: "screenwidth", "screenheight", 
  229.    "screendepth", and "screenmode".    
  230. -- The current directory is now restored upon exit (if it was
  231.    ever changed).
  232. -- Added version strings to all executables.
  233. -- Plotting real vectors on polar plots used to fake complex
  234.    vectors by using the real value for both the real and
  235.    imaginary parts.  The imaginary part is now set to zero
  236.    instead.
  237.  
  238. 1.2
  239. -- Much better CTRL-C handling (other than simply exiting).
  240. -- Fixed a problem with pz searches.  I made the algorithm more
  241.    robust should it screw up; in the process I ran into a bug in
  242.    the C= IEEE libraries.
  243. -- Fixed a little problem when the screen font and the plot font
  244.    were not the same height.
  245. -- Added variables to control fonts: "fontname" and "fontheight". 
  246. -- "Press return..." prompting now appears on both the plot
  247.    screen and in the console window.
  248. -- Added experimental variable to control pz analysis: 
  249.    "pzniterlim" and "pzusesym2".  They don't seem to do much...
  250. -- CR-LF combinations in source files should no longer cause 
  251.    confusion.
  252. -- ASRC model working much better now (Enforcer hits appear to be
  253.    gone).
  254. -- Fixed Enforcer hit when setting some variables
  255.    ("program"/"rawfile").
  256. -- Recompiled without "NOVM" flag, yielding much better
  257.    convergence (at least for the ltra examples).
  258.  
  259. 1.3
  260. -- Added list of supported devices/analyses to this file.
  261. -- Updated my email address.
  262. -- Changed math library of "000" version from IEEE to "standard".
  263. -- Recompiled with SAS/C 6.56.
  264. -- PostScript output no longer produces redundant "moveto" 
  265.    directives.
  266. -- International characters are no longer mangled.
  267. -- Some imperfections in the online help files were fixed (both
  268.    in spice.txt and spice3f4.guide).
  269. -- Miscellaneous bug fixes (i.e., I've been sloppy about updating
  270.    this file since the r2 release and I simply don't remember).
  271.  
  272. Suggestions and Bugs to...
  273.  
  274. Henric Jungheim <henric@zoom.com>
  275.  
  276.